home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / LINKS60.ZIP / GOLF.DOC < prev    next >
Text File  |  1997-02-21  |  19KB  |  412 lines
  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║                                                                             ║
  3. ║                       CorpSoft BBS (815) 886-9388                           ║
  4. ║                         3 Nodes - USR 28.8  v.34                            ║
  5. ║                                                                             ║
  6. ║                          LINKS COUNTRY CLUB GOLF                            ║
  7. ║                                    v6.0                                     ║
  8. ║                                                                             ║
  9. ║                              MULTI-BBS Support                              ║
  10. ║           Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,          ║
  11. ║                UltraBBS, Telegard, TriTel, and Remote Access                ║
  12. ║                                                                             ║
  13. ║                               Copyright 1997                                ║
  14. ║                               by Robert Neal                                ║
  15. ║                             317 Hickory Avenue                              ║
  16. ║                            Romeoville, IL  60446                            ║
  17. ║                                                                             ║
  18. ╚═════════════════════════════════════════════════════════════════════════════╝
  19.  
  20. Links is a golfing simulation game, with either 9 or 18 holes offered
  21. for play. Users golf by making their club selection, woods, irons,
  22. wedges and putter. Yardage is determined by a set standard plus a random
  23. variable to keep the game interesting.
  24.  
  25. The Links Country Club Golf (Links) is released as SHAREWARE. You are granted
  26. a limited license to evaluate the program. Try it out, if you continue to use 
  27. it for more than 30 days you are required to register the program.
  28.  
  29. To register the program send $15.00 along with your name and BBS name
  30. to: Robert Neal, 317 Hickory Avenue, Romeoville, IL 60446. See the file
  31. MAILER.TXT for additonal pricing information and special discounts
  32. available. You may also register ONLINE with Visa or MasterCard by
  33. calling the support BBS at (815) 886-9388. Simply type CHARGE at the menu.
  34.  
  35. Once you register Links Golf, you will be given your own unique 
  36. registration number. The BBS name supplied with payment will be the name 
  37. used to create your unique registration number.
  38.  
  39. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  40. WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  41. LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  42. PARTICULAR PURPOSE.  IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND
  43. PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL
  44. DAMAGES, ARISING OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  45.  
  46.  
  47. FEATURES OF THE LINKS COUTNRY CLUB GOLF
  48. =======================================
  49.  
  50.   -  Ansi color support.
  51.   -  Terminates cleanly through exit code even on runtime error.
  52.   -  Automatically creates a top score listing suitable for inclusion
  53.      as a text/bulletin file for display within your BBS. 
  54.   -  Detects loss of carrier.
  55.   -  Operates in local mode (either direct from BBS or from command line).
  56.   -  Sysop function keys to return to the board, chat mode, user stats,
  57.      increase/decrease time, etc.
  58.   -  Direct support for PCBoard, WildCat!, Gap, QBBS, RBBS, Ultra BBS,
  59.      Telegard, TriTel and Remote Access.
  60.   -  Support for baud rates up to 115,200
  61.   -  Support for COM0-15. Optional command line for non-standard IRQ's.
  62.   -  Supports PCBoard environment variables %PCBDRIVE% and %PCBDIR%
  63.   -  Fully Multi-Node compatible.
  64.   -  Course editor (LINKARCH) added to customize the course layout.
  65.      For REGISTERED versions only.
  66.   -  Optional automated monthly rollover maintenance.
  67.  -  Supports fossil based, multi-port digiboards, as used with PCBoard
  68.      /M version.
  69.  -  ANSI representation of each hole
  70.  -  Optional "adopted by" banner to acknowledge users who contribute.
  71.     towards registration of the game.
  72.  -  Command line local play option to evaluate the program.
  73.  
  74.  
  75.  
  76. CONFIGURING THE PROGRAM
  77.  
  78. You may use GCONFIG.EXE to create and/or edit the configuration files.
  79. To use GCONFIG, type GCONFIG GOLF.CFG. This editor will allow you to
  80. enter the appropriate configuration editor within it's own full screen
  81. editor. GCONFIG will also convert registration data from version prior
  82. to v3.3 to the new method used beginning with v3.3.  Below is the layout
  83. of the GOLF.CFG file if you wish to edit it manually.
  84.  
  85.  
  86. C:\PCB\PCBOARD.SYS
  87. Corporate Headquarters
  88. Bob
  89. Neal
  90. 0
  91. NA
  92.  
  93. Line 1 = Full pathname of your door file. Formats supported by this
  94.           program are: PCBOARD.SYS, USERS.SYS, DOOR.SYS, USERINFO.DAT,
  95.                       CALLINFO.BBS, DORINFOx.DEF, SFDOORS.DAT and
  96.                       GTUSER.BBS, DOOR.SYS, and TRIBBS.SYS. When using
  97.                       USERINFO.DAT, DOOR.SYS  must be in the same
  98.                       directory as USERINFO.DAT.
  99. Line 2 = BBS name
  100. Line 3 = Sysop First Name
  101. Line 4 = Sysop Last Name
  102. Line 5 = Registration number. Leave as 0 if unregistered.
  103. Line 6 = You can place the name of the user who helped pay for the
  104.         registration of the door. Several sysops have specified that
  105.         users have paid the reigstration fee for War of the Words. You can
  106.         now place their name on this line and their name will be
  107.         proudly displayed at the end of the game so that others may
  108.         recognize their contribtion to the operation of your BBS.
  109.         Leave this blank or NA if you do not wish to use this
  110.         option.
  111.  
  112. Additionally, all CorpSoft doors allow you to fully evaluate the
  113. program without the need to setting up the door and running it
  114. from your BBS (we don't know why all doors don't include this feature,
  115. being a sysop myself, it's a real hassle to evaluate some doors).
  116. If you are running the program from the command line, enter WOTW LOCAL.
  117. The default user name SysOp is used. This is good for testing
  118. but you should once play begins, execute the program from your BBS
  119. or consistantly run the game from the command line when you play.
  120.  
  121. You may also specify a non-standard IRQ. Put the IRQ number after the
  122. .CFG on the command line. For example: GOLF GOLF.CFG /5. This tells
  123. the program to use IRQ 5 instead of the standard IRQ.
  124.  
  125. You may also use the procedure above and create a variable IRQ so that
  126. you can pass the IRQ setting as: GOLF GOLF.CFG /%IRQ%
  127.  
  128. Some users may have had conflicts when using non-standard IRQ's on
  129. Novell/Netware systems. Novell seems to use the "/" character for
  130. parameter passing. You may not optionally use the "*" character instead
  131. of the "/", for example GOLF GOLF.CFG *%IRQ% is valid. Both "*" and
  132. "/" will work.
  133.  
  134. Note: This door supports the PCBoard environment variables %PCBDRIVE%
  135. and %PCBDIR%. Non-PCBoard systems may also use these variables by
  136. including the following either in your BBS batch or AUTOEXEC.BAT file:
  137.  
  138.     SET PCBDRIVE=C:            <- Drive letter of your BBS files
  139.     SET PCBDIR=\BBS            <- Path of your BBS files
  140.  
  141. Then, in your GOLF.CFG file, on the first line you may put:
  142.  
  143.    %PCBDRIVE%%PCBDIR%\PCBOARD.SYS, %PCBDRIVE%%PCBDIR%\DOOR.SYS, etc.
  144.  
  145. This allows you to use just one .CFG file for multi-node operation.
  146.  
  147.  
  148.  
  149. EXECUTING PROGRAM
  150. =================
  151.  
  152. To execute the program, enter the filename followed by the config file
  153. name (ie GOLF GOLF.CFG). If you are running the program from the command
  154. line, you may optionally enter GOLF.EXE LOCAL. The only problem with this is
  155. the default user name sysop is used instead of the username on your board.
  156. This is good for testing the game before putting it on your system, but
  157. you should once play begins execute the program locally from your BBS or
  158. consistantly run the game from the command line when you play.
  159.  
  160. This documentation will not go into the details of how you set-up a door
  161. program on your BBS. It is assumed that you have a working knowledge of
  162. how to complete this task. As each BBS is different, trying to explain
  163. the installation procedure for every BBS is not possible.
  164.  
  165. You may also specify a non-standard IRQ. Put the IRQ number after the
  166. .CFG on the command line. For example: GOLF GOLF.CFG /5. This example tells
  167. the program to use IRQ 5 instead of the standard IRQ.
  168.  
  169. You may also use the procedure above and create a variable IRQ so that
  170. you can pass the IRQ setting as: GOLF GOLF.CFG /%IRQ%.
  171.  
  172. Some users may have had conflicts when using non-standard IRQ's on
  173. Novell/Netware systems. Novell seems to use the "/" character for
  174. parameter passing. You may not optionally use the "*" character instead
  175. of the "/", for example GOLF GOLF.CFG *%IRQ% is valid. Both "*" and "/"
  176. will work.
  177.  
  178. FOSSIL DRIVER
  179. =============
  180.  
  181. Links Golf now includes support for FOSSIL drivers. This means that the
  182. program will now work with Digiboard (for Wildcat IM and PCBoard/M
  183. versions) and other fossil based multi-port boards. To activate the
  184. Fossil driver support just include /FD on the command line in your door
  185. batch file.
  186.  
  187.         For example: GOLF GOLF.CFG /FD
  188.  
  189. If no Fossil driver is available, Links Golf will display a message
  190. indicating such and exit cleanly.
  191.  
  192.  
  193.  
  194. FILES USED
  195. ===========
  196.  
  197. GOLF.EXE  - The program itself
  198. GOLF.DOC  - Documentation for the sysop to run The Links
  199. GOLF.CFG  - Configuration file
  200. GOLF.FIL  - Best scores file (top 5)
  201. GOLF.CRS  - Data file of the course. New to version 2.0 is the option to
  202.             alter the course layout by using the program LINKARCH. 
  203.             NON-REGISTERED users may NOT alter the course. The file
  204.             LINKARCH has been included for you to see how easy it is to
  205.             modify the course to your own personal layout. If you are
  206.             using a NON-REGISTERED version DO NOT alter the course, either
  207.             with a text editor or the LINKARCH program. Doing so will 
  208.             result in the game failing to load.
  209. GOLF.LOG  - This file is created when the program is run. This file will
  210.             contain a synopsis of activity in the door, who played,
  211.             number of holes played and even if they got a whole in one.
  212. HOLExx.ANS- ANSI graphic representation of each hole. Graphics included
  213.             with this program are for the default course. If you make
  214.             any modifications to the course with LINKARCH, you will need
  215.             to modify the respective HOLExx.ANS file using your favorite
  216.             ANSI editor.
  217. BALL.ANS  - ANSI representation of a golf ball.
  218. GOLFOPEN.ANS- ANSI image displayed at start up of program.
  219.  
  220.  
  221. REINITIALIZING THE SCOREBOARD
  222. =============================
  223.  
  224. Every so often you may want to reset the scoreboard (especially when you
  225. have the scoreboard filled with LOW scores that would be difficult or
  226. impossible to better). To reset the scoreboard enter GOLF INIT and the
  227. game will automatically reinitialize the scoreboard. You may also copy 
  228. over the original unmodified scoreboard included in this archive to 
  229. esentially reset the game.
  230.  
  231.  
  232. MONTHLY ROLLOVER MAINTENANCE
  233. ============================
  234.  
  235. You may optionally have Links Golf automatically rollover the scoreboard
  236. on a monthly basis by entering GOLF MAINTxx (where xx is the day of the
  237. month you want to rollover the scoreboard). For example, to reset your
  238. scoreboard on the first of each month, enter GOLF MAINT1. To reset on
  239. the 15th, enter GOLF MAINT15. This command should be run as part of your
  240. BBS nightly event processing. If maintenance is not required, the
  241. program will exit cleanly. If maintenance is required, the program
  242. will automatically reset the scoreboard information.
  243.  
  244.                 
  245.  
  246.  
  247. THE GAME ITSELF
  248. ===============
  249.  
  250. The game starts by displaying The Links opening screen (please do not
  251. modify this or any other part of the game), and will ask the user if he 
  252. wants to use ANSI colors. While the door info file passes the variable for
  253. if a user has ANSI on or off, this gives those players a chance who may have
  254. ANSI off for normal BBS useage to use ANSI colors while in the door.
  255.  
  256. From here he is asked if he wants to play 9 or 18 holes. If he selects 9
  257. holes he is then asked if he wishes to play the front 9 or back 9. He is
  258. then asked if he wishes to read the instructions on how to play The Links.
  259.  
  260. When prompted for club selection entering QUIT (or 'Q') will terminate
  261. play. Entering HELP (or 'H') will display a listing of available clubs
  262. and approximate distances.
  263.  
  264. |An ANSI representation of each hole is included with this program. If
  265. |the user has ANSI capabilities, the graphic image will be displayed. If
  266. |the user does not have ANSI capabilities, the program will not display
  267. |the image.
  268.  
  269. After the user has played all 9 or 18 holes his ranking is shown if he
  270. beats one of the top 5 scores. The best score file is then updated and
  271. the program asks the user if he wishes to play again or not.
  272.  
  273. SYSOP KEYS ACTIVE
  274.  
  275. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  276.          written to DOOR.SYS and USERS.SYS
  277. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  278.          and/or written to DOOR.SYS and USERS.SYS
  279. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  280. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  281.          and/or written to DOOR.SYS and USERS.SYS
  282. F8    -  Returns the caller involuntarily to the BBS.
  283. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  284.          and/or written to DOOR.SYS and USERS.SYS
  285. F10   -  Activates SysOp CHAT mode within the DOOR.
  286. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  287. UP    -  Give the caller extra time while in the DOOR.  
  288. DN    -  Subtract time from the caller while in the DOOR. 
  289. HOME  -  HELP key for Status Line options.
  290. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  291. ALT-X -  PCBoard will exit after current caller logs off. Value is
  292.          passed to PCBoard. Not available on non-PCBoard systems.
  293.  
  294.  
  295.  
  296.  
  297.  
  298. THE LINKS COURSE EDITOR (LINKARCH.EXE)
  299. ======================================
  300.  
  301. The file GOLF.CRS contains the information concerning the course layout
  302. and MUST be edited using LINKARCH. Attempts to edit the program with a
  303. text editor will result in the game failing to execute. 
  304.  
  305. The course editor should only be used by REGISTERED users of The Links
  306. Country Club Golf. NON-REGISTERED versions will fail to execute if the
  307. orignal GOLF.CRS file is edited in anyway.
  308.  
  309. The LINKARCH file is contained in this archived file so that previously
  310. registered users have the file available without needing to request it 
  311. and also so that NON-REGISTERED users can see how easy it is to edit
  312. the course, though any changes made will not be saved.
  313.  
  314. When using the course editor you should be certain to keep the par
  315. for the front and back nine the same. As a rule of thumb, distances
  316. less than 250 yards should be a par 3, 250-375 a par 4 and anything over
  317. 375 yards should be set as par 5. 
  318.  
  319. ADOPTED BY OPTION (Registered version only)
  320. ===========================================
  321.  
  322. Many sysops are fortunate to have their users offer to register a door
  323. they enjoy playing. You can now give recognition to the user or users
  324. who assist in contributing to the registration of this program. Simply 
  325. enter their name(s) on the appropriate line in the configuration file.
  326.  
  327. When unregistered, the door will inform the user that they can adopt
  328. the door and refers them to ask you for details. You can give the
  329. user the registration form for them to send in if you'd like.
  330.  
  331. After the program is registered, each time a user quits the game a
  332. screen will be displayed informing other users who contributed towards
  333. the registration of the game. 
  334.  
  335. If you wish to disable this option, enter NA on the line in the 
  336. configuration file.
  337.  
  338.  
  339.  
  340. TROUBLESHOOTING
  341. ================
  342.  
  343. -  If you are running this Door on a 486 system and encounter an error
  344.    message "ERROR 6 - OVERFLOW ERROR" or you experience irratic Keyboard
  345.    Timeout messages, you may have to put the following in either your
  346.    AUTOEXEC.BAT file or in the batch file you use to call this program.
  347.  
  348.      SET NO87=ON
  349.  
  350.    If you are running on a 486 system with co-processor under DesqView, you
  351.    may alternately set Math Coprocessor in each window to YES.
  352.  
  353. -  If you encounter an ERROR 62 when the program first is loaded, this
  354.    will usually indicate that there is an error in your .CFG file. 
  355.    Recheck your .CFG file to verify the proper format (if you use the
  356.    WOTWCFG program you should never encounter this error).
  357.  
  358. -  An ERROR 70 message means you more than likely do not have SHARE
  359.    loaded. This is typically only required for multi-node systems.
  360.  
  361.  
  362.  
  363. CONTACT ME FOR SUPPORT
  364. =======================
  365.  
  366. If you encounter any problems you may contact me at CorpSoft BBS
  367. (815) 886-9388.
  368.  
  369. I can also be reached via the RIME network in the SYSOP, DOORS,
  370. SHAREWARE and BBS SOFTWARE conferences as well as the COMMON conference.
  371. I can also be reached via Internet e-mail at bob.neal@corpsoft.com. or
  372. via FIDO at 1:115/886 (Bob Neal@1:115/886).
  373.  
  374. If you have any suggestions for improvements for this program, please feel
  375. free to let me know. This game has included suggestions from users during
  376. beta testing.
  377.  
  378.  
  379. *DISTRIBUTION SITES*
  380.  
  381.    As always you can find the latest version of War of the Words available
  382.    for downloading from CorpSoft BBS.
  383.  
  384.    CorpSoft BBS   (815) 886-9388 (3 nodes with automatic ring-down,
  385.                   running USR 28800 v.everything)
  386.  
  387. We also accept Visa and Mastercard. Register online with your Visa or
  388. Mastercard by calling CorpSoft BBS, simply type CHARGE at the main menu
  389. prompt.
  390.  
  391. User's with FIDO capabilities can FREQ the latest version of my software 
  392. from me at 1:115/886. The magic names for my software are:
  393.     WOTW            War of the Words
  394.     KING            Kings are Wild Solitaire
  395.     CARD            Card Sharks
  396.     BOWL            BBS Bowling Solitaire
  397.     GOLF            Links Golf
  398.     ZWORD           Z-Wordz
  399.     CORPSOFT        All my shareware releases
  400.  
  401. You can also download our files via our web site. Visit us at
  402. http://user.aol.com/corpsoft
  403.  
  404. To further make it convenient for people to download my software, you can
  405. also login to my support BBS by enter CORPSOFT GUEST when prompted for 
  406. your name. You will not need to go through the new user information
  407. questionaire and will immediately be able to download my shareware. 
  408. Please note that if you wish to register online, you will need to
  409. set-up a user account so that your registration keys can be made available
  410. to you.
  411.  
  412.